home *** CD-ROM | disk | FTP | other *** search
/ OpenGL Superbible (2nd Edition) / OpenGL SuperBible e2.iso / tools / GLUT-3.7 / README.xinput < prev    next >
Encoding:
Text File  |  1998-08-12  |  7.9 KB  |  266 lines
  1.  
  2. GLUT NOTE:  The GLUT API version 2 & 3 X11 implementations support the SGI
  3. Dials and Buttons, SGI Spaceball, and SGI Tablet via the X Input
  4. extension.  These devices are advertised as described below.  If other
  5. vendors advertise these X Input extension devices differently, GLUT's X
  6. implementation will need to be extended to properly support such
  7. differently advertised devices.
  8.  
  9.  
  10.     X Input Extension Devices as Advertised by Silicon Graphics
  11.  
  12.                             Mark Kilgard
  13.  
  14.                          February 13, 1995
  15.  
  16.                              $Revision: 1.2 $
  17.  
  18. This document describes how Silicon Graphics Inc. (SGI) advertises its
  19. support for input devices through the X Input extension.  Because the X
  20. Input extension only provides mechanism for supporting additional X
  21. input devices, vendors may support the same or similar devices in
  22. slightly different ways making it difficult for programs to count on
  23. how a given input device will be supported across vendors.
  24.  
  25. The intent of this document is not to propose any standard way of
  26. supporting specific X Input extension devices, but merely to thoroughly
  27. describe SGI's X Input support for the benefit of X Input programmers
  28. and other X Input extension implementors wishing to mimic SGI's X Input
  29. support to avoid needless incompatibility for otherwise standard and
  30. common input devices.
  31.  
  32. The client queriable state returned by the X Input extension is not
  33. enough to effectively use X Input extension devices.  The physical
  34. layout of how the dials, axes, buttons, etc. are laid out is not
  35. queriable.  Effective use of the extension requires knowledge of the
  36. physical layout of the devices.  Diagrams are provided to show the
  37. actual layout.
  38.  
  39. Comments and corrections should be sent to Mark Kilgard <mjk@nvidia.com>
  40. (Please note that I no longer work at Silicon Graphics.  Try contacting
  41. Peter Daifuku <daifuku@sgi.com) if you need to contact SGI about this
  42. information.)
  43.  
  44. SGI Dials and Buttons:
  45.  
  46.   Device type:                    KNOB_BOX
  47.   Device name:                    dial+buttons
  48.   Classes:                        2
  49.     ButtonClass
  50.       Number buttons:             32
  51.     ValuatorClass
  52.       Device mode:                Absolute
  53.       Number axes:                8
  54.     Axis 1
  55.       Minimum value:          -32768
  56.       Maximum value:          32767
  57.       Resolution:             200
  58.     Axis 2
  59.       Minimum value:          -32768
  60.       Maximum value:          32767
  61.       Resolution:             200
  62.     Axis 3
  63.       Minimum value:          -32768
  64.       Maximum value:          32767
  65.       Resolution:             200
  66.     Axis 4
  67.       Minimum value:          -32768
  68.       Maximum value:          32767
  69.       Resolution:             200
  70.     Axis 5
  71.       Minimum value:          -32768
  72.       Maximum value:          32767
  73.       Resolution:             200
  74.     Axis 6
  75.       Minimum value:          -32768
  76.       Maximum value:          32767
  77.       Resolution:             200
  78.     Axis 7
  79.       Minimum value:          -32768
  80.       Maximum value:          32767
  81.       Resolution:             200
  82.     Axis 8
  83.       Minimum value:          -32768
  84.       Maximum value:          32767
  85.       Resolution:             200
  86.  
  87.   Physical layout:
  88.  
  89.        +---------+
  90.        | (7) (8) |
  91.        |         |
  92.        | (5) (6) |
  93.        |         |   <---- Dials on dial box w/ axis number
  94.        | (3) (4) |
  95.        |         |
  96.        | (1) (2) |
  97.        +---------+
  98.  
  99.        +-------------------------------+
  100.        |      [ 1] [ 2] [ 3] [ 4]      |
  101.        |                               |
  102.        | [ 5] [ 6] [ 7] [ 8] [ 9] [10] |
  103.        |                               |
  104.        | [11] [12] [13] [14] [15] [16] |  <--- Buttons on button box
  105.        |                               |       w/ button number
  106.        | [17] [18] [19] [20] [21] [22] |
  107.        |                               |
  108.        | [23] [24] [25] [26] [27] [28] |
  109.        |                               |
  110.        |      [29] [30] [31] [32]      |
  111.        +-------------------------------+
  112.  
  113.   Device manufacturer:            Seiko
  114.  
  115. SGI SpaceBall:
  116.  
  117.   Device type:                    SPACEBALL
  118.   Device name:                    spaceball
  119.   Classes:                        2
  120.     ButtonClass
  121.       Number buttons:             9
  122.     ValuatorClass
  123.       Device mode:                Absolute
  124.       Number axes:                7
  125.     Axis 1
  126.       Minimum value:          -18000
  127.       Maximum value:          18000
  128.       Resolution:             200
  129.     Axis 2
  130.       Minimum value:          -18000
  131.       Maximum value:          18000
  132.       Resolution:             200
  133.     Axis 3
  134.       Minimum value:          -18000
  135.       Maximum value:          18000
  136.       Resolution:             200
  137.     Axis 4
  138.       Minimum value:          -18000
  139.       Maximum value:          18000
  140.       Resolution:             200
  141.     Axis 5
  142.       Minimum value:          -18000
  143.       Maximum value:          18000
  144.       Resolution:             200
  145.     Axis 6
  146.       Minimum value:          -18000
  147.       Maximum value:          18000
  148.       Resolution:             200
  149.     Axis 7
  150.       Minimum value:          -18000
  151.       Maximum value:          18000
  152.       Resolution:             200
  153.  
  154.   Physical layout:
  155.  
  156.      +-----------------+
  157.      | [1] [2] [3] [4] |   <---  Function keys
  158.      | [5] [6] [7] [8] |
  159.      |                 |
  160.      |    /--[9]--\    |   <---  Pick button (hidden on ball surface)
  161.      |   /         \   |
  162.      |  |  "the     |  |         Axes 1-3   X, Y, Z rotation
  163.      |  |   ball"   |  |         Axes 4-6   X, Y, Z translation
  164.      |  |           |  |         Axis 7     Period
  165.      |   \         /   |
  166.      |    \-------/    |         X is left and right; Y is up and down;
  167.      |                 |         Z is back and forward.
  168.      +-----------------+
  169.  
  170.   Device manufacturer:            SpaceBall Technologies, Inc. Lowell, MA
  171.                   (508) 970-0330.
  172.  
  173. SGI Tablet:
  174.  
  175.   Device type:                    TABLET
  176.   Device name:                    tablet
  177.   Classes:                        2
  178.     ButtonClass
  179.       Number buttons:             4
  180.     ValuatorClass
  181.       Device mode:                Absolute
  182.       Number axes:                2
  183.     Axis 1
  184.       Minimum value:          0
  185.       Maximum value:          2206
  186.       Resolution:             200
  187.     Axis 2
  188.       Minimum value:          0
  189.       Maximum value:          2206
  190.       Resolution:             200
  191.   Physical layout:
  192.  
  193.             -----
  194.            / (+) \        The tablet puck crosshair
  195.           /   |   \
  196.          /    |    \
  197.          +---------+
  198.          |   <1>   |      The tablet puck buttons.
  199.          |         |
  200.          | <2> <4> |
  201.          |         |
  202.          |   <3>   |
  203.           \       /
  204.        +-----+
  205.  
  206.   Device manufacturer:            Hitachi
  207.  
  208. SGI Virtual Pointer:
  209.  
  210.   Device type:                    VIRTUAL_POINTER
  211.   Device name:                    virtual_pointer
  212.   Classes:                        2
  213.     ButtonClass
  214.       Number buttons:             5
  215.     ValuatorClass
  216.       Device mode:                Absolute
  217.       Number axes:                2
  218.     Axis 1
  219.       Minimum value:          0
  220.       Maximum value:          1280
  221.       Resolution:             200
  222.     Axis 2
  223.       Minimum value:          0
  224.       Maximum value:          1024
  225.       Resolution:             200
  226.   Physical layout:                n/a
  227.   Device manufacturer:            n/a
  228.   Notes:  The virtual_pointer allows multiple physical devices to "push"
  229.     a single logical pointer.  The virtual pointer is an SGI feature.
  230.  
  231. SGI Mouse:
  232.   
  233.   Device type:                    MOUSE
  234.   Device name:                    mouse
  235.   Classes:                        2
  236.     ButtonClass
  237.       Number buttons:             3
  238.     ValuatorClass
  239.       Device mode:                Absolute
  240.       Number axes:                2
  241.     Axis 1
  242.       Minimum value:          0
  243.       Maximum value:          65000
  244.       Resolution:             200
  245.     Axis 2
  246.       Minimum value:          0
  247.       Maximum value:          65000
  248.       Resolution:             200
  249.   Physical layout:
  250.     
  251.     +-------------+
  252.     |             |
  253.     | [1] [2] [3] |  <---  Buttons on mouse w/ button numbers.
  254.     |             |
  255.     |             |
  256.     |             |
  257.     |             |
  258.     +-------------+
  259.  
  260.     Axis 1 is for mouse motion in X axis (left & right)
  261.     Axis 2 is for mouse motion in Y axis (top & bottom)
  262.  
  263.   Device manufacturer:            SGI
  264.  
  265.  
  266.